home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / dmedia / aifcresample.z / aifcresample
Text File  |  1998-10-30  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4. aaaaiiiiffffccccrrrreeeessssaaaammmmpppplllleeee((((1111))))                                                aaaaiiiiffffccccrrrreeeessssaaaammmmpppplllleeee((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      aifcresample - perform sampling rate conversion on an AIFF-C file
  10.  
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      aifcresample [options] -rate rate infile.aifc outfile.aifc
  14.  
  15.  
  16. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  17.      ----rrrraaaatttteeee _r_a_t_e
  18.            specifies the sampling rate for the output file _o_u_t_f_i_l_e._a_i_f_c. The
  19.            value _r_a_t_e must be one of the following (sample frames per second):
  20.  
  21.  
  22.            8888000000000000    11111111000022225555    11116666000000000000    22222222000055550000    33332222000000000000    44444444111100000000    44448888000000000000
  23.  
  24.  
  25.            The sampling rate specified for the output file must be different
  26.            from the sampling rate of the input file.
  27.  
  28.  
  29.      ----ddddyyyynnnnaaaammmmiiiicccc _d_e_c_i_b_e_l_s
  30.            specifies the minimum attenuation (in decibels) of the alias/image
  31.            artifacts generated by the sampling rate conversion.  The loss in
  32.            dynamic range due to the rate conversion process will be no worse
  33.            than this value.
  34.  
  35.  
  36.            The value for _d_e_c_i_b_e_l_s must be one of: 77778888, 99996666, or 111122220000.  Default
  37.            value is 99996666. A higher value for _d_e_c_i_b_e_l_s gives higher quality rate
  38.            conversion.
  39.  
  40.  
  41.      ----ttttaaaappppeeeerrrr _b_a_n_d_w_i_d_t_h
  42.            specifies the percentage of the final bandwidth tapered off.  A
  43.            smaller percentage of tapered bandwidth corresponds to a greater
  44.            high frequency content. Conversions to low sampling rates should
  45.            use higher values for _b_a_n_d_w_i_d_t_h.
  46.  
  47.  
  48.            The value for _b_a_n_d_w_i_d_t_h must be chosen from: 1111, 11110000, or 22220000. Default
  49.            value is 11110000. A lower value for _b_a_n_d_w_i_d_t_h gives higher quality rate
  50.            conversion.
  51.  
  52.  
  53.      ----vvvveeeerrrrbbbboooosssseeee
  54.            causes the program to print out messages periodically which
  55.            indicate how much of the data in the original file has been
  56.            converted.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaaiiiiffffccccrrrreeeessssaaaammmmpppplllleeee((((1111))))                                                aaaaiiiiffffccccrrrreeeessssaaaammmmpppplllleeee((((1111))))
  71.  
  72.  
  73.  
  74. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  75.      _a_i_f_c_r_e_s_a_m_p_l_e is a command-line program which reads an AIFF-C (or AIFF)
  76.      digital audio input file, converts the audio data to new sampling rate,
  77.      and writes out a new AIFF-C file containing the resampled data.
  78.  
  79.  
  80.      _a_i_f_c_r_e_s_a_m_p_l_e uses high-quality rate conversion algorithms with linear
  81.      phase filters to perform resampling between any two of the following
  82.      rates: 8000, 11025, 16000, 22050, 32000, 44100, 48000 sample frames per
  83.      second (or Hz).
  84.  
  85.  
  86.      The speed of the rate conversion algorithm depends on the values
  87.      specified for _b_a_n_d_w_i_d_t_h, _d_e_c_i_b_e_l_s, and the original and new sampling
  88.      rates.
  89.  
  90.  
  91.      If the input AIFF-C file parses correctly, and the output file is written
  92.      with no errors, _a_i_f_c_r_e_s_a_m_p_l_e returns 0. If there is an error,
  93.      _a_i_f_c_r_e_s_a_m_p_l_e returns 1.
  94.  
  95.  
  96.      The  AIFF-C file format specification is published by Apple Computer Inc.
  97.  
  98.  
  99. NNNNOOOOTTTTEEEESSSS
  100.      Files converted using _d_e_c_i_b_e_l_s set to 96 and _b_a_n_d_w_i_d_t_h set to 10 will
  101.      sound most excellent.  For the highest quality conversion algorithm,
  102.      however, you can set _d_e_c_i_b_e_l_s to 120 and _b_a_n_d_w_i_d_t_h to 1.  By decreasing
  103.      _d_e_c_i_b_e_l_s and increasing _b_a_n_d_w_i_d_t_h, you increase the speed of the rate
  104.      conversion at a loss of high frequency response.
  105.  
  106.  
  107.      The following table shows the relationships between the _b_a_n_d_w_i_d_t_h
  108.      parameter, and the pass band ripple:
  109.  
  110.  
  111.                bandwidth      % final        passband
  112.                parameter bandwidth      ripple
  113.                          tapered
  114.  
  115.                20        20%       +/- 0.05   dB
  116.                10        10%       +/- 0.05   dB
  117.                 1         1%       +/- 0.0005 dB
  118.  
  119.  
  120.  
  121. BBBBUUUUGGGGSSSS
  122.      Due to convolution remnants at the beginning of the output file's audio
  123.      data, there may be some inaccuracy in rescaled loop points or markers.
  124.      The leading convolution remnant may displace some valid audio data at the
  125.      end of the file. The magnitude of this inaccuracy depends on the rate
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. aaaaiiiiffffccccrrrreeeessssaaaammmmpppplllleeee((((1111))))                                                aaaaiiiiffffccccrrrreeeessssaaaammmmpppplllleeee((((1111))))
  137.  
  138.  
  139.  
  140.      conversion bandwidth parameters and input and output sampling rates.
  141.      aifcresample simply multiplies existing loop points by the ratio
  142.      output/input sampling rate.
  143.  
  144.  
  145. AAAAUUUUTTTTHHHHOOOORRRR
  146.      Gints Klimanis and Scott Porter, Silicon Graphics Inc.
  147.  
  148.  
  149. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  150.      playaifc(1), recordaifc(1),
  151.      aifc2aiff(1), aifccompress(1), aifcdecompress(1),
  152.      dmconvert(1), mediaconvert(1)
  153.      AIFF-C File Format Specification
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.